百度地图服务生态

订单详情接口 | 百度->商户

更新时间：2023-02-20

获取订单详情

接口描述

本接口用于查询当前订单详情，无缓存

用途

订单状态变更回传【callbackbytp】通知属于异步回调，完全依赖三方回传会存在延迟或回调失败的情况，因此需要百度侧主动轮询三方订单详情接口，及时变更订单状态

权限说明

注意事项

  1. 超时时间：要求接口耗时小于1.5S（超过1.5S触发超时重试），重试策略：接口超时默认重试3次。
  2. 返回值判断：
    a.返回数据格式：json，包含字段如：{"errno":0,"msg":"success","data":{}}

请求参数

参数名称 类型 是否必选 参数位置 描述
bd_pre_order_id String 是 RequestBody参数 百度唯一单号
bd_pay_order_id String 是 RequestBody参数 百度支付单号
tp_order_id String 是 RequestBody参数 商户订单号

响应参数

参数名称 父节点 类型 是否必传 描述
errno 无 int 是 错误码，0：成功
msg 无 string 是 结果描述，success：成功
data 无 json 是 预定结果
bdOrderId data string 是 百度支付订单号
orderTitle data string 是 订单名称
tpStatus data string 是 订单状态，码表
tplStatus data string 是 订单状态
payAmount data string 是 支付金额，分
discountAmount data string 否 补贴金额，分
refundAmount data string 否 退款金额，（已支付且三方同意取消的订单需要返回）
qrcode data string 否 适用于壳牌油站，壳牌油站属于二维码核销油站，需要 TP提供券码，百度侧在订单详情页生成二维码展示，tpStatus=2的时候会存在券码

请求示例

{
    "tp_name":"test",
    "salt":681161,
    "timestamp":1648642558,
    "sign":"ca852a6df07aa4653d1d0848bd893247",
    "bd_pay_order_id":"test_1509118392932671488"
}

响应示例

{
    "errno": 0,
    "errstr": "",
    "desc": "操作成功",
    "data": {
        "bdOrderId": "test_1509118392932671488",
        "orderTitle": "西三旗加油站",
        "tplStatus": "已完成",
        "tpStatus": "10",
        "payAmount": "18100",
        "discountAmount": "600",
        "refundAmount":"",
        "qrcode":"适用于壳牌油站，壳牌油站属于二维码核销油站，需要 TP提供券码，百度侧在订单详情页生成二维码展示，tpStatus=2的时候会存在券码"
    }
}

tpStatus订单状态码表

取值 释义 描述
2 待使用 核销码模式，待使用
4 已退款 商户已退款
5 已完成 订单已完成
9 已取消 未支付已取消

错误码

errno 描述 处理
0 成功
1000 参数错误 检查加密参数与必传参数是否有误
2100 order no exists 订单不存在
加油下单&支付 | 百度->商户获取 Openid| 商户->百度